home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / pcboard / kspmts33.zip / WHATSNEW.DOC < prev   
Text File  |  1996-10-02  |  46KB  |  989 lines

  1.  
  2.  
  3.  
  4.                           WHAT'S NEW IN KSP-MAIL
  5.  
  6.  
  7.      3.3:  New  Feature:  The "pulled" version of News-In now uses the
  8.            "MODE  READER" command in preference to the "SLAVE" command
  9.            (which  was  never  widely  implemented by NNTP servers) in
  10.            order  to  notify the server that KSP-Mail is a news reader
  11.            client.    If   the  "MODE  READER"  command  is  rejected,
  12.            KSP-Mail will then try the "SLAVE" command.  
  13.  
  14.            New      Feature:     Added     configuration     parameter
  15.            "ksp-mail.logging"  which  may be set to "disabled" to turn
  16.            off  logging  and  is  also controllable via Remote Systems
  17.            Management.  
  18.  
  19.            Bug  Fix: The remote systems management commands "LIST DEL"
  20.            and "PROCESS PAUSE" were broken; corrected.  
  21.  
  22.            Bug  Fix:  PCB-VRFY  did  not properly handle BBS usernames
  23.            that  included  a  period,  as  in  "Mr.  James".   On  the
  24.            Internet,   this  becomes  "Mr..James"  (if  the  separator
  25.            character  is  defined  as  a period); given such a name in
  26.            Internet  format,  PCB-VRFY would try to locate "Mr  James"
  27.            (no    periods)   in   the   PCBoard   username   database.
  28.            Corrected.  
  29.  
  30.            Enhancement:   PCB-VRFY   required   several  seconds  when
  31.            attempting  to  open  a  non-existant  file due to retries.
  32.            (This  had a noticeable effect if the file ALIAS.IN did not
  33.            exist in the UUCP base path.) Corrected.  
  34.  
  35.            Enhancement:  The "... Opening log ..." line is now written
  36.            to  a  log file only if the date has changed since the last
  37.            opening.  
  38.  
  39.            Enhancement:  Modified  the  News-Out  and  pulled  News-In
  40.            clients  to  respond  to  an  AUTHINFO  request  after  any
  41.            rejected  command,  not  just  at login.  Now automatically
  42.            recognizes  and supports both the original "AUTHINFO USER /
  43.            AUTHINFO  PASS"  format  and  the  "AUTHINFO SIMPLE" format
  44.            proposed  in  NNTP v2 specification and implemented on some
  45.            NNTP  servers.  This required, however, a change in the way
  46.            the  AUTHINFO  username  and  password are specified in the
  47.            ksp-mail.nntp_server   parameter;   see   KSP-MAIL.DOC  for
  48.            details.  
  49.  
  50.            Clean  Up:  Removed  AUTHINFO  support  from Mail-Out since
  51.            ESMTP/SMTP  does  not use it; AUTHINFO is only supported by
  52.            NNTP.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                           WHAT'S NEW IN KSP-MAIL
  63.  
  64.  
  65.      3.2:  Bug  Fix: Changes made in version 3.1 caused pulled News-In
  66.            to   write  over  the  newsgroupslist  (e.g.,  GROUPS.LST).
  67.            Corrected.  
  68.  
  69.            Enhancement:  Added "root", "uucp", and "usenet" to the set
  70.            of   mailbox   names  ("postmaster",  "mailer-daemon",  and
  71.            "sysop") that Mail-In automatically verifies.  
  72.  
  73.            Enhancement:  PCB-VRFY.EXE  now  uses  the  name  separator
  74.            specified  in  the  UUCP  portion of PCBSetUp and stored in
  75.            PCBOARD.DAT (defaults to ".").  
  76.  
  77.            Enhancement:  PCB-VRFY.EXE  now uses the PCBoard's ALIAS.IN
  78.            file  (if  any) to translate mailbox aliases to user names.
  79.            This  file  is  located in the UUCP base path, specified in
  80.            the UUCP portion of PCBSetUp.  
  81.  
  82.            Bug  Fix:  KSP-VRFY.EXE  and  PCB-VRFY.EXE  would hang if a
  83.            file I/O error occurred during execution; corrected.  
  84.  
  85.      3.1:  Major  Bug  Fix!:  If a timeout occured while receiving the
  86.            text  of  an inbound email message, KSP-Mail would send the
  87.            error  message  "421  Internal  problem, mail discarded" to
  88.            the  remote  client  and  go back to look for the next SMTP
  89.            command  from  the  client; however, the client would still
  90.            be  sending  the  remainder  of  the  message text and this
  91.            confused  the  command  interpreter, causing the program to
  92.            ultimately  crash.  Now, after KSP-Mail sends the 421 error
  93.            message  to  the  client,  it  logs  an  explanation of the
  94.            nature   of   the  internal  error,  and  then  aborts  the
  95.            connection.         The        default       value       of
  96.            "ksp-mail.server_timeout"  has  now  been increased from 60
  97.            seconds to 300 seconds (5 minutes) per RFC 1123.  
  98.  
  99.            Bug  Fix:  The  NNTP  server  implemented  by  the "pushed"
  100.            version  of  News-In  was  using  the  value of "sockdelay"
  101.            rather than "ksp-mail.server_timeout".  Corrected.  
  102.  
  103.            Bug  Fix:  The  wrong  time  stamp  was  being  recorded in
  104.            POSTED.IDX,  thus  affecting  removal  of  old news article
  105.            ID's.  Corrected.  
  106.  
  107.            Clean   Up:   Mail-In  log  files  have  been  renamed  for
  108.            consistency (e.g., MAIL-IN.001 is now MAIL-IN1.LOG).  
  109.  
  110.            Clean Up: Renamed PCBNEWSG.EXE to PCB-GRPS.EXE.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                           WHAT'S NEW IN KSP-MAIL
  121.  
  122.  
  123.            New  Feature:  Added  a  log  file  for  the  execution  of
  124.            external commands (EXT-CMDS.LOG).  
  125.  
  126.            New  Feature:  Added  six  new  configuration parameters to
  127.            limit       growth       of      log      files      (e.g.,
  128.            "ksp-mail.log_days_newsin=<days>").  (See KSP-MAIL.DOC) 
  129.  
  130.            New  Feature: Added support in Mail-In for the EXPN (Expand
  131.            Mailing   List)  command  of  SMTP.   (See  description  of
  132.            "ksp-mail.mailing_list") 
  133.  
  134.            New  Feature:  Added  support  for an external program that
  135.            implements  the  ESMTP  command  "VRFY" to check whether or
  136.            not  a  username is local to the BBS.  Program is specified
  137.            using the new parameter, "ksp-mail.vrfy_program".  
  138.  
  139.            New   Feature:  Added  ksp-mail.sitename_alias  to  support
  140.            situations  where  the  hostname  used  in  the destination
  141.            address  of  mail  sent to your local site differs from the
  142.            actual hostname of the machine.  
  143.  
  144.            New  Feature:  Added  support  to limit the size of inbound
  145.            news  articles.   The  default  is no limit, but can be set
  146.            using the parameter "ksp-mail.max_article_bytes".  
  147.  
  148.            New  Feature:  Created  KSP-PACK.EXE to pack the POSTED.IDX
  149.            file; loaded and executed by KSP-Mail at midnight.  
  150.  
  151.            Enhancement:   Mail-In  now  builds  recipient  list  in  a
  152.            temporary  file  (RCPT-TO#.$,  where  "#"  is  the  session
  153.            number  1-4) rather than in memory, eliminating any concern
  154.            of running out of available heap space.  
  155.  
  156.            Enhancement:  Replaced  configuration parameter "sockdelay"
  157.            by  "ksp-mail.client_timeout"  with  default  value  of 300
  158.            seconds  (5  minutes)  per  RFC  1123.   Used by all client
  159.            processes;  twice  this  value  is  used  by Mail-Out while
  160.            waiting  for  acknowledge reply after transmitting the text
  161.            of an email message.  
  162.  
  163.            Enhancement:  Added  "Return-Path:"  line  to  top  of  RFC
  164.            header on inbound email messages.  
  165.  
  166.            Change:  If  a  client  logs  into  the Mail-In or (pushed)
  167.            News-In  as  the  remote  systems  manager, the server will
  168.            switch  to  management  mode  and  only management commands
  169.            will  be  recognized.   Because  of this, these commands no
  170.            longer  begin  with  a  period; e.g., ".HELP" is now simply
  171.            "HELP".  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                           WHAT'S NEW IN KSP-MAIL
  179.  
  180.  
  181.  
  182.      3.0:  New   Feature:   Remote  Systems  Management  is  now  also
  183.            accessible through the NNTP server when news is "pushed".  
  184.  
  185.            Clean-Up:  Added "Max-Article-Days" and "Max-Message-Bytes"
  186.            to  the  set  of parameters that can be modified via remote
  187.            system management.  
  188.  
  189.            Enhancement:       Changed       default      value      of
  190.            "ksp-mail.max_article_days" from 14 to 7.  
  191.  
  192.      2.9:  New  Feature: Added support in Mail-In for the SMTP command
  193.            "VRFY".   This  optional  command  was  not required by the
  194.            original   SMTP   spec   (RFC  821),  but  has  since  been
  195.            designated  mandatory  by  STD 3, RFC 1123.  Since KSP-Mail
  196.            does  not have access to the usernames valid on the BBS, it
  197.            must  always  give a positive response to the VRFY command,
  198.            whether   the   user  exists  or  not;  responsibility  for
  199.            rejection   of  the  inbound  message  due  to  an  invalid
  200.            username is left to the UUCP import utility.  
  201.  
  202.            Enhancement:   The   inbound   email   message  size  limit
  203.            introduced  in version 2.8 now works even with clients that
  204.            do   not   support   the   ESMTP  "SIZE"  parameter.   Such
  205.            (non-compliant)  clients  still transmit the entire content
  206.            of  their  message,  but  KSP-Mail  simply rejects it after
  207.            transmission,  and  without  using  disk  space  beyond the
  208.            limit  specified;  compliant  clients,  however, cancel the
  209.            transfer and save transmission time.  
  210.  
  211.            Enhancement:  Mail-Out  now uses the ESMTP "SIZE" parameter
  212.            if the remote host supports it.  
  213.  
  214.      2.8:  New  Feature:  Added support for the ESMTP "SIZE" parameter
  215.            to  limit  the  size  of inbound mail messages delivered by
  216.            ESMTP-compliant  clients.  The default is no limit, but can
  217.            be set using the parameter "ksp-mail.max_message_bytes".  
  218.  
  219.            Bug  Fix:  Discovered  that  the  Waterloo  TCP/IP  library
  220.            routine  that  reads a line of text from the network failed
  221.            when the input buffer contained an ASCII NUL.  Corrected.  
  222.  
  223.      2.7:  New  Feature:  Added  parameter "ksp-mail.max_article_days"
  224.            to  limit on how many days the ID of a news article is kept
  225.            in  the  POSTED.IDX  database  file  to  prevent  import of
  226.            duplicate articles.  Default is 14 days.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                           WHAT'S NEW IN KSP-MAIL
  237.  
  238.  
  239.            Bug  Fix: News-Out was not looking at the first line of the
  240.            RFC  header.   If that line was a "From:", "Newgroups:", or
  241.            "Message-ID:"  line,  then  it  would  be  missed,  and the
  242.            article  would  be  rejected  thinking  it  had  a  bad RFC
  243.            header.  
  244.  
  245.            Bug  Fix:  News-In  was aborting in the middle of a batched
  246.            outbound  news  file if the NNTP server rejected an article
  247.            in  the  batch  because  (a) it already has the article, or
  248.            (b)  because  the  newsgroup  is not carried by the server.
  249.            Corrected.  
  250.  
  251.            Bug  Fix:  If  outbound  news  is  batched  and one or more
  252.            articles  within  a  batch  file  had  a  bad  RFC  header,
  253.            News-Out   would   abort   the   remainder   of  the  file.
  254.            Corrected:  now  it  merely bypasses such articles making a
  255.            notation  in the logs, continues posting the good ones, and
  256.            then renames the .XQT file as a .BAD file.  
  257.  
  258.            Clean  Up:  Mail-In  now  writes  a  single line at the top
  259.            (before  the  RFC  header) of each mail message as required
  260.            by uucp.  The format of the line is: 
  261.  
  262.                "From <sender> <day> <month> <date> <time> <year>"
  263.  
  264.            This  line  can  be  disabled setting the new configuration
  265.            parameter "ksp-mail.uucp_from_line" to "disabled".  
  266.  
  267.            Clean  Up:  No  longer aborts News-Out session when attempt
  268.            to post article is rejected by remote NNTP server.  
  269.  
  270.            Clean       Up:      Reversed      the      default      on
  271.            "ksp-mail.retrieve_hostnames".     The   default   now   is
  272.            disabled; the parameter may be used to set it to enabled.  
  273.  
  274.            Enhancement:  The  pushed  version of News-In processed the
  275.            received  news  when  the newsfeed client issued the "QUIT"
  276.            command   to   close   the  session.   However,  some  Unix
  277.            newsfeeds  never  close  the  connection  in  an attempt to
  278.            improve  throughput.   This  leads  to timeouts which abort
  279.            the  connection; the newsfeed then reopens a new connection
  280.            when  more  news  is  available  to  be pushed.  The pushed
  281.            version  of  News-In  now  processes the received news when
  282.            the  connection  is terminated, whether it's due to a valid
  283.            QUIT command or a timeout.  
  284.  
  285.            Enhancement:  Added ksp-mail.newnews_timeout to specify how
  286.            many  seconds  KSP-Mail  will  wait  for  a response to the
  287.            NEWNEWS  command  when  asking for the list of new articles
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.                           WHAT'S NEW IN KSP-MAIL
  295.  
  296.  
  297.            posted  to a newsgroup.  This option was added because this
  298.            time  delay can be quite long compared to other time delays
  299.            when  asking  for  news  from  a  date  several days in the
  300.            past.  
  301.  
  302.            Enhancement:  KSP-Mail  kept  track  of  which articles had
  303.            already  been  imported  in  a file called POSTED.NWS; only
  304.            articles  posted  to  multiple  newsgroups and those from a
  305.            partial  newsgroup  retrieval were recorded in this file to
  306.            minimize   file  size.   As  articles  were  imported,  new
  307.            articles   were   skipped   if   already  imported.   Since
  308.            POSTED.NWS  was a "flat" file, searching was sequential and
  309.            seriously  degraded performance near the end of a news pull
  310.            when  there  were  more  than  a thousand newsgroups.  This
  311.            file  has  now  been  replaced by a B+ database file called
  312.            POSTED.IDX;  all  posted article IDs are recorded, and then
  313.            removed  at  the  end  of  a  newspull  if  older  than all
  314.            date/time entries in the newsgroups list.  
  315.  
  316.            Enhancement:  KSP-Mail  previously detected the presence of
  317.            DESQview  and  released  time slices to it accordingly, but
  318.            was   not   changing   the   way  it  painted  the  screen;
  319.            corrected.  
  320.  
  321.      2.6:  Enhancement:  Renamed  file  "NEW-GRPS.LOG" to "GROUPS.NEW"
  322.            and   moved   it  to  the  same  directory  pointed  to  by
  323.            ksp-mail.newsgroupslist.  
  324.  
  325.            Enhancement:   Increased   the  size  of  files  (lists  of
  326.            newsgroups  or  article  ids)  that  can  be  sorted by (1)
  327.            swapping  KSP-Mail  out  of  memory  while sorting, and (2)
  328.            creating  KSP-SORT.EXE,  which  sorts larger files than the
  329.            MS/DOS SORT.EXE program.  
  330.  
  331.            Enhancement:  Added  reverse  domain  name  lookup (from IP
  332.            address)  to obtain a reliable identification of the remote
  333.            host(s).    Set  "ksp-mail.retrieve_hostnames=disabled"  to
  334.            disable it; default is enabled.  
  335.  
  336.            Enhancement:  KSP-Mail  is  now  "OS/2 aware".  I.e., it no
  337.            longer  uses  100%  of  the  cpu  time,  but  rather it now
  338.            releases the cpu to other processes when it's not busy.  
  339.  
  340.            New   Feature:  KSP-Mail  will  now  optionally  creates  a
  341.            zero-byte  file  on  a periodic basis as an indication that
  342.            everything  is  still ok.  This allows you to setup a batch
  343.            file  on  another machine that continuously checks the date
  344.            stamp  on  the file and issues an alarm if it has been more
  345.            than  a  certain  amount  of  time  since the file was last
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.                           WHAT'S NEW IN KSP-MAIL
  353.  
  354.  
  355.            created.  (See "ksp-mail.ok_filespec".) 
  356.  
  357.            New  Feature: Remote system management.  Now you can telnet
  358.            into  KSP-Mail  from  a remote location to modify or view a
  359.            large  number  of  operating parameters!  This replaces the
  360.            old  "HELP  STATUS" and "RSET STATUS" commands with a whole
  361.            new  set  of  "extended" commands, and accordingly, the old
  362.            "ksp-mail.status_password"   configuration   parameter  has
  363.            been   renamed   to  "ksp-mail.remote_management_password".
  364.            Since  the  extended  commands permit run-time modification
  365.            of  operating  parameters, they are disabled unless (1) the
  366.            password  has been specified, and (2) the remote client has
  367.            identified   itself   to   KSP-Mail  at  login  with  "HELO
  368.            <password>".   See  the  new  chapter  in  KSP-MAIL.DOC  on
  369.            remote system management for more information.  
  370.  
  371.            New  Feature:  News-In now is able to run as a receive-only
  372.            NNTP  server.  This allows KSP-Mail to receive inbound news
  373.            via  a  news  "feed"  rather  than  polling  a  remote NNTP
  374.            server.   Receiving  a  news  feed  is  known as the "push"
  375.            method,  and  significantly  reduces the load on the remote
  376.            machine  compared  to  "pulling"  news.   If  configuration
  377.            parameter  "ksp-mail.newsgroups"  is  defined, then News-In
  378.            runs  as  a  client  and pulls news; otherwise it runs as a
  379.            server  and  waits  for  a  news  feed client to push.  See
  380.            KSP-MAIL.DOC for further information.  
  381.  
  382.            Enhancement:   The   "ksp-mail.news_hour"   parameter   now
  383.            supports  a  list of hours, separated by commas; a range of
  384.            hours may also be specified by using a dash.  For example, 
  385.  
  386.                        ksp-mail.news_hour=2,4,6,7-12,20-22
  387.  
  388.            New  Feature:  Retrieval  of  hundreds  of newgroups is not
  389.            uncommon,  and  can  take several hours to complete.  Since
  390.            no  external UUCP import/export programs are allowed to run
  391.            until  all  TCP/IP processes (e.g., News-In) are idle, this
  392.            situation  can  seriously  delay  import/export of mail and
  393.            news.   In  this version, if the ",sort" option is appended
  394.            to  the  end  of  the parameter "ksp-mail.newsgroups", then
  395.            News-In  will  be  suspended  at  the  end  of  the current
  396.            newsgroup   if   an  external  program  is  waiting  to  be
  397.            executed.   Note  that if "ksp-mail.news_import_trigger" is
  398.            set  to "on_arrival", then this allows external programs to
  399.            be executed between each pair of newsgroups.  
  400.  
  401.            Enhancement:   Created   less-confusing   aliases  for  the
  402.            following configuration parameters: 
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.                           WHAT'S NEW IN KSP-MAIL
  411.  
  412.  
  413.            Original Parameter Name         Alternative Parameter Name
  414.            ----------------------------    --------------------------
  415.            ksp-mail.bbsmail2uucp_command   ksp-mail.export_mail_command
  416.            ksp-mail.bbsmail2uucp_seconds   ksp-mail.export_mail_seconds
  417.            ksp-mail.bbsmail2uucp_trigger   ksp-mail.export_mail_trigger
  418.            ksp-mail.bbsnews2uucp_command   ksp-mail.export_news_command
  419.            ksp-mail.bbsnews2uucp_seconds   ksp-mail.export_news_seconds
  420.            ksp-mail.uucp2bbsmail_command   ksp-mail.import_mail_command
  421.            ksp-mail.uucp2bbsmail_seconds   ksp-mail.import_mail_seconds
  422.            ksp-mail.uucp2bbsmail_trigger   ksp-mail.import_mail_trigger
  423.            ksp-mail.uucp2bbsnews_command   ksp-mail.import_news_command
  424.            ksp-mail.uucp2bbsnews_trigger   ksp-mail.import_news_trigger
  425.  
  426.            Enhancement:  Created  additional  configuration  parameter
  427.            aliases   as   follows,  with  a  new  ability  to  specify
  428.            different NNTP servers for News-In and News-Out: 
  429.  
  430.            Original Parameter Name         Alternative Parameter Name
  431.            ----------------------------    --------------------------
  432.            ksp-mail.nntp_server            ksp-mail.news_server, or
  433.                                            ksp-mail.news_in_server, or
  434.                                            ksp-mail.news_out_server
  435.  
  436.            ksp-mail.smtp_server            ksp-mail.mail_server, or
  437.                                            ksp-mail.mail_out_server
  438.  
  439.            Enhancement:  Added six additional configuration parameters
  440.            that  enable/disable  individual  processes  and report any
  441.            missing   parameters  required  by  those  processes.   See
  442.            KSP-MAIL.DOC for more information.  
  443.  
  444.                    ksp-mail.import_news_process
  445.                    ksp-mail.import_news_process
  446.                    ksp-mail.import_mail_process
  447.                    ksp-mail.export_news_process
  448.                    ksp-mail.export_mail_process
  449.                    ksp-mail.command_shell_process
  450.                    ksp-mail.set_clock_process
  451.  
  452.            Enhancement:  If an SMTP or NNTP server rejects an outbound
  453.            message,  the  original  message preceded by an appropriate
  454.            explanation is returned to the sender.  
  455.  
  456.            New  Feature:  Added  "ksp-mail.smtp_greeting" to allow you
  457.            to  add  your  own  text  to  the  login  greeting  message
  458.            presented  by Mail-In to the remote client.  This parameter
  459.            may be repeated for multi-line messages.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.                           WHAT'S NEW IN KSP-MAIL
  469.  
  470.  
  471.            New  Feature:  Added  a  new configuration parameter called
  472.            "ksp-mail.exit_spec=<filespec>[,<seconds>]".     If   used,
  473.            KSP-Mail  will  periodically  check  for  a  file  matching
  474.            <filespec>.   If  found, KSP-Mail deletes the file and then
  475.            exits  as  soon as it reaches a stable state, with an error
  476.            code  given by the three-character filename extension.  The
  477.            <filespec>  string  may  contain  wildcards.  The <seconds>
  478.            parameter  is  optional  and  specifies  how frequently the
  479.            check  is  made;  default  is  once  every 10 seconds.  For
  480.            example,  with "ksp-mail.exit_spec=c:\ksp\ksp-exit.*,5" the
  481.            file  c:\ksp\ksp-exit.015  will cause KSP-Mail to exit with
  482.            an error code of 15.  
  483.  
  484.            New  Feature: Some NNTP servers require the client to login
  485.            with  a username and password.  Since such commands are not
  486.            part  of  the  NNTP  standard,  they  have  been  added  to
  487.            KSP-Mail  as  strings  separated  by commas and appended to
  488.            the  end of the "ksp-mail.nntp_server" configuration entry,
  489.            as in: 
  490.  
  491.             ksp-mail.nntp_server=129.210.212.20,<string>,<string>,...
  492.  
  493.            where, for example, "<string>" might be: 
  494.  
  495.                    authinfo user ksp
  496.            or:     authinfo pass babyface
  497.  
  498.            If  blanks appear within one or more of the commands (as in
  499.            these  examples),  then  everything after the "=" sign must
  500.            be surrounded by a pair of quotation marks.  
  501.  
  502.            This  feature can be used in the specification of SMTP (but
  503.            not TIME) servers as well.  
  504.  
  505.            Bug  Fix:  Mail-Out  wasn't handling outbound mailing lists
  506.            properly.   It  used  the  "To:" field in the RFC header of
  507.            the  message  instead  of  the  recipient  list in the .XQT
  508.            file.  Corrected.  
  509.  
  510.            Bug  Fix:  UUCP  sometimes  puts  a  "From  ..." line in an
  511.            outbound  mail  message  or  news article at the top before
  512.            the  RFC  header.  This line is not a legal RFC header line
  513.            and was not being removed.  Corrected.  
  514.  
  515.            Bug  Fix:  Outbound  mail  or  news  with either a "To:" or
  516.            "From:" line of the format: 
  517.  
  518.                    John Smith (King of the Road) <jsmith@nowhere.com> 
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                           WHAT'S NEW IN KSP-MAIL
  527.  
  528.  
  529.            would    cause    the    address   parser   that   extracts
  530.            "jsmith@nowhere.com" to fail.  Corrected.  
  531.  
  532.            Bug  Fix:  Use  of domain names instead of IP addresses for
  533.            SMTP,  NNTP,  or TIME servers corrupted memory which caused
  534.            failures later while importing newsgroups.  Corrected.  
  535.  
  536.      2.5:  New   Feature:  If  a  timeout  occurs  in  the  middle  of
  537.            retrieving  articles  from  some newsgroup, a list of those
  538.            that  have  already  been  retrieved  will be recorded in a
  539.            file so that they will not be retrieved again.  
  540.  
  541.            New   Feature:  If  you  add  ",sort"  after  the  filename
  542.            specified  by  ksp-mail.newsgroups, then KSP-Mail will sort
  543.            the  file  before  retrieval so that it attempts to get the
  544.            oldest news first.  
  545.  
  546.            New  Feature:  Added  a  new configuration parameter called
  547.            "ksp-mail.close_timeout"  to  limit the amount of time used
  548.            to   close   a   connection  independent  of  other  limits
  549.            specified  by "sockdelay" and "server_timeout".  Default is
  550.            10 seconds.  
  551.  
  552.            Bug  Fix: If no *.XQT files were in the spool directory, it
  553.            would  sometimes  die  with an error message saying "out of
  554.            file handles".  Corrected.  
  555.  
  556.      2.4:  Enhancement:   You   no   longer  have  to  change  the  TZ
  557.            environment  variable  string  when  Daylight  Savings Time
  558.            (DST)  begins  or  ends.   If  the  TZ  environment  string
  559.            includes  a  DST  suffix  (e.g.,  "SET  TZ=PST8PDT"),  then
  560.            KSP-Mail  will  now  automatically  set the clock ahead one
  561.            hour  at 2am on the first Sunday in April and back one hour
  562.            at  2am  on  the  last Sunday in October.  If TZ does *NOT*
  563.            include  a DST suffix (e.g., "SET TZ=PST8"), then the clock
  564.            will not be changed.  
  565.  
  566.            Enhancement:  Added  a  new  configuration parameter called
  567.            "ksp-mail.outbound_retry_seconds".   If posting an outbound
  568.            mail  message  or news article fails due to a timeout while
  569.            waiting  for  the  remote  server  to  reply,  KSP-Mail now
  570.            delays   for   the   amount   of  time  specified  by  this
  571.            parameter.  
  572.  
  573.            Enhancement:  News-Out  tries  to post an article using the
  574.            "POST"  NNTP  command; if that is refused, it now tries the
  575.            "IHAVE" command.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.                           WHAT'S NEW IN KSP-MAIL
  585.  
  586.  
  587.            Enhancement:   If  Mail-Out  or  News-Out  encountered  any
  588.            problem  while  trying  to  post  a message or article, the
  589.            corresponding  .XQT  file  was renamed to .BAD, even if the
  590.            problem  was  not due to errors in the file itself.  (E.g.,
  591.            a  server  timeout  would  also  result  in  the file being
  592.            renamed.)   Now, Mail-Out and News-Out only rename the file
  593.            if  there  is  actually  something wrong with its contents;
  594.            this allows the file to be resent at a later time.  
  595.  
  596.            Clean  Up:  News-In:  Eliminated the "skipping cross-posted
  597.            article.."  message-In,  and  the cross-posted article from
  598.            the  total  number  of  articles  to  be retrieved for that
  599.            newsgroup.   Improved  the  algorithm that detects feedback
  600.            articles;  rather  than importing and then discarding, they
  601.            are no longer imported.  
  602.  
  603.            Bug  Fix:  Running  external commands would sometimes cause
  604.            KSP-Mail to crash if swapping was allowed.  Corrected.  
  605.  
  606.      2.3:  Bug  Fix:  While  cleaning  up  the code for version 2.2, I
  607.            accidentally  reversed  the sense of a test which broke the
  608.            new  code  that  gets  a  list  of  new newsgroups (not new
  609.            articles) from the NNTP server.  Corrected.  
  610.  
  611.      2.2:  Enhancement:  News-In  article  list  no  longer  sorted if
  612.            there's only one article in the list. <g> 
  613.  
  614.            Bug  Fix: If the response to the NEWNEWS command of News-In
  615.            was  a  list  of  articles  containing only a single entry,
  616.            that article was not retrieved; corrected.  
  617.  
  618.      2.1:  Bug  Fix: At the end of a news retrieval, the date and time
  619.            computed    for   the   next   retrieval   was   incorrect.
  620.            Corrected.  
  621.  
  622.      2.0:  MAJOR  NEW  RELEASE:  This is the successor to version 1.8,
  623.            and  has  been  numbered  2.0  rather  than  1.9 because it
  624.            incorporates  a  large  number of significant improvements,
  625.            new features, and bug fixes.  
  626.  
  627.            Configuration  Change: Previous versions kept a single time
  628.            and  date  record  of  the  last  news  retrieval in a file
  629.            called  NEWS-IN.LST;  there  was  only  one  date  and time
  630.            recorded  for  all  newgroups.  Retrieving articles for any
  631.            one  group can take several minutes, so it became necessary
  632.            to  record  the  time  and  date on a group-by-group basis.
  633.            This  version  eliminates  the NEW-IN.LST file and replaces
  634.            the "ksp-mail.newsgroup" configuration parameter by: 
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.                           WHAT'S NEW IN KSP-MAIL
  643.  
  644.  
  645.                    ksp-mail.newsgroups=<filespec> 
  646.  
  647.            as in: 
  648.  
  649.                    ksp-mail.newsgroups=c:\ksp\groups.lst 
  650.  
  651.            Note  the  added  's'  at  the  end  of  "newsgroups".   As
  652.            indicated,  this new parameter requires a filespec (without
  653.            a  leading  '@').  The file contains one line per newsgroup
  654.            (no  wildcards); each entry consists of a GMT date and time
  655.            followed  by  the  newgroup  name, with fields separated by
  656.            exactly one space: 
  657.  
  658.                    YYMMDD HHMMSS newgroup_name 
  659.  
  660.            as in: 
  661.  
  662.                    951001 120012 alt.bbs.internet 
  663.  
  664.            Note:  If you want to sort this new newsgroup list by name,
  665.            use the following DOS command: 
  666.  
  667.                    SORT /+14 < infile > outfile 
  668.  
  669.            where  "infile"  is the name of the unsorted newsgroup list
  670.            and "outfile" is the name of the sorted list.  
  671.  
  672.            Note:  If  you create an entry where the newsgroup name has
  673.            been  replaced  by  the  IP address of your NNTP server, as
  674.            in: 
  675.  
  676.                    951001 120012 137.168.1.1 
  677.  
  678.            then  KSP-Mail will record new newsgroups whenever they are
  679.            created  on the server!  The list of new newsgroups will be
  680.            added  to the end of a log file called NEW-GRPS.LOG in your
  681.            log  directory.   If  you  have multiple NNTP servers, just
  682.            create  one  line for each server with the corresponding IP
  683.            addresses.  
  684.  
  685.            New  Feature: A Set-Clock thread has been added.  It uses a
  686.            time  server  on  the  Internet to set the time and date of
  687.            the  KSP-Mail  machine.  To use it, you must specify one or
  688.            more  time  servers  using  "ksp-mail.time_server"; you may
  689.            also  want  to  set  how  often  the  clock  is  set  using
  690.            "ksp-mail.set_clock_hours"  (the  default  is once every 24
  691.            hours).  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.                           WHAT'S NEW IN KSP-MAIL
  701.  
  702.  
  703.            New  Feature: You may now include more than one NNTP server
  704.            in  your  WATTCP.CFG  file. If the first NNTP server is not
  705.            available,  KSP-Mail will try the second, and so on.  Also,
  706.            if  one  or more of the specified newsgroups is not carried
  707.            by  a server, KSP-Mail will attempt to retrieve the missing
  708.            newsgroups from the remaining servers in the list.  
  709.  
  710.            New  Feature:  The  SMTP  server implemented by the Mail-In
  711.            processes  now  supports  an  extension  of SMTP's standard
  712.            "HELP"  and  "RSET"  commands  that can be used to remotely
  713.            retrieve  information  about the current status of KSP-Mail
  714.            via  telnet;  see chapter five of KSP-MAIL.DOC for details.
  715.            Access  to these commands can be password protected using a
  716.            new          configuration         parameter         called
  717.            "ksp-mail.status_password".  
  718.  
  719.            New  Feature:  UUCP  export utilities usually use temporary
  720.            names  while creating the spool files and then rename those
  721.            files  after  they  have been completely written.  However,
  722.            occassionally  this  design  practice  is not followed, and
  723.            can  cause  a  "file sharing violation" when other software
  724.            (such  as  KSP-Mail)  is  trying to read these files.  As a
  725.            workaround,    a   new   configuration   parameter   called
  726.            "ksp-mail.share_delay_seconds"  has  been  added  to  cause
  727.            KSP-Mail  to  delay  before  actually trying to process the
  728.            file.   If set properly, this should allow the UUCP utility
  729.            time  to  finish  writing  to  the  file, thus avoiding the
  730.            access conflict.  
  731.  
  732.            Enhancement:  Pressing  Esc  once  now  exits  only  if all
  733.            processes   are   idle.   Pressing  it  twice  exits  after
  734.            gracefully  completing  any transfer in progress.  Pressing
  735.            it three times aborts and exits immediately.  
  736.  
  737.            Enhancement:  Additional information related to News-In and
  738.            News-Out  is  now displayed on the Summary Screen.  (1) the
  739.            current  NNTP  server's  IP  address,  (2)  the current and
  740.            total   number  of  newsgroups  being  retrieved,  (3)  the
  741.            current  and total number of articles in the current group,
  742.            and  (4)  the  time  and date of the previous retrieval for
  743.            the current group.  
  744.  
  745.            Enhancement:  News-In  now  sorts  the list of article id's
  746.            returned  by  the  "NEWNEWS"  command before retrieving the
  747.            articles.   This  helps  keep  multi-part  postings  (e.g.,
  748.            part1  of  3,  part  2  of  3,  etc.)  in the proper order.
  749.            (Note:  KSP-Mail loads and executes the DOS "SORT" command,
  750.            which must be in the current path.) 
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.                           WHAT'S NEW IN KSP-MAIL
  759.  
  760.  
  761.            Enhancement:  News-In  now  retrieves  articles  using  the
  762.            faster  "ARTICLE" command rather than the slower "HEAD" and
  763.            "BODY" commands.  
  764.  
  765.            Enhancement:  News-In  now uses the "SLAVE" command to tell
  766.            the  NNTP  server  that KSP-Mail provides news to more than
  767.            one  person; this command is ignored by most servers, but a
  768.            few may give you higher priority.  
  769.  
  770.            Clean  Up:  Version  1.8  added a new feature to facilitate
  771.            mail   forwarding:   the  full  email  destination  address
  772.            (including  the  domain  name)  was written to the UUCP *.X
  773.            file  when  the  domain name was different from that of the
  774.            KSP-Mail  machine.   Some UUCP utilities can't forward mail
  775.            and  thus  accept  nothing  more  than  a user name.  A new
  776.            configuration  parameter  (ksp-mail.forwarding=enabled) has
  777.            been  added  to  solve  this problem; if not used, only the
  778.            user  name will be written to the *.X file.  THIS PARAMETER
  779.            MUST  BE  ENABLED  IF YOU WANT MAIL FOR ANOTHER DOMAIN NAME
  780.            TO BE FORWARDED.  
  781.  
  782.            Bug  Fix:  Mail-In  was  not  properly  handling  a  single
  783.            inbound  mail  message  posted  to  multiple recipients; it
  784.            only  delivered  a copy to the recipient specified with the
  785.            last  (of  multiple)  "RCPT  TO" command sent by the remote
  786.            SMTP client.  Corrected.  
  787.  
  788.            Bug  Fix:  The  "NEWNEWS"  command  issued  by  the News-In
  789.            process  to  the  remote  NNTP  server  did not specify the
  790.            "GMT" option (Greenich Mean Time); corrected.  
  791.  
  792.            Bug  Fix:  When articles were cross-posted to more than one
  793.            newsgroup,  duplicate  entries  would be posted by the uucp
  794.            utilities to the BBS message base.  Corrected.  
  795.  
  796.      1.8:  New  Feature:  KSP-Mail  now handles outbound news that has
  797.            been  batched by the UUCP software.  Such files contain one
  798.            or  more  news articles, each preceded within the same file
  799.            by  a line like "#! rnews <number>".  Most NNTP servers can
  800.            handle this anyway, but some do not.  
  801.  
  802.            New  Feature:  Some  UUCP  software  (like GIGO) can handle
  803.            .XQT    files    that    contain   a   line   like   "rmail
  804.            dan.lewis@ksp.com";  such  software  uses  the  domain name
  805.            information  to  implement  mail forwarding.  Less powerful
  806.            UUCP  software  (e.g.,  UUIN) tolerates nothing more than a
  807.            user  name,  such  as  "rmail dan.lewis", assuming that all
  808.            incoming  mail is for the local machine.  KSP-Mail has been
  809.            modified  so  that  now  if  the  domain  name  part of the
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.                           WHAT'S NEW IN KSP-MAIL
  817.  
  818.  
  819.            destination  address  of  an inbound e-mail message matches
  820.            that  of  the  KSP-Mail  machine (as configured in WATTCP),
  821.            then  the  domain  name  information  is removed as before;
  822.            otherwise  it  is  passed to the UUCP software on the rmail
  823.            command line in the .XQT file.  
  824.  
  825.            Bug  Fix:  External commands that required loading a second
  826.            copy  of  COMMAND.COM, such as .BAT files, or commands with
  827.            command    line   redirection   or   piping   would   fail.
  828.            Corrected.  
  829.  
  830.            Bug  Fix:  Discovered  a bug in the Waterloo TCP/IP library
  831.            function  that reads a line of text from the network.  This
  832.            caused   KSP-Mail  to  freeze  if  a  client  SMTP  process
  833.            submitted  an  e-mail message containing a line longer than
  834.            1024 characters.  Corrected.  
  835.  
  836.            Bug  Fix:  If  the  Mail-In  process  was disabled (no mail
  837.            directory  specified),  none  of  the  other processes were
  838.            able  to borrow one of the four network resources needed to
  839.            function.  Corrected.  
  840.  
  841.            Clean  Up:  The  Mail-In  process'  response  to  a  "HELP"
  842.            command    issued   by   the   remote   SMTP   client   was
  843.            double-spaced; corrected.  
  844.  
  845.            Clean  Up:  Initiated  process  activity woke up the screen
  846.            saver,   but  sometimes  the  moving  screen  saver  string
  847.            "KSP-Mail"  would be written on top of the restored summary
  848.            screen; corrected.  
  849.  
  850.      1.7:  Bug  Fix:  If  the  "From:"  line  of  the RFC header on an
  851.            outbound  mail  message or news article appeared before the
  852.            "To:"  line  (as opposed to the other way around), KSP-Mail
  853.            would  issue  the  error  message,  "Bad RFC header in file
  854.            ...".  Corrected.  
  855.  
  856.      1.6:  Bug  Fix:  When swapping to EMS, the code that releases the
  857.            allocated  EMS  memory  (after  KSP-Mail's  memory image is
  858.            restored)  was  not  working.   This  caused  EMS memory to
  859.            eventually be depleted.  Corrected.  
  860.  
  861.            Enhancement:  If  an  error  occured  during  processing of
  862.            outbound  mail  or news, the corresponding uucp spool files
  863.            for  that  message  would  be  left in the spool directory,
  864.            causing  KSP-Mail  to  try  over  and  over again to export
  865.            them.    This   has   been   corrected   by   renaming  the
  866.            corresponding .XQT file with the extension .BAD.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.                           WHAT'S NEW IN KSP-MAIL
  875.  
  876.  
  877.            Clean  Up:  Forgot  to  document  the  need  to set your TZ
  878.            (timezone)  environment  variable.   The  time standard for
  879.            both   SMTP  and  NNTP  is  Greenwich  Mean  Time;  the  TZ
  880.            environment  variable  tells  KSP-Mail  how to convert your
  881.            local   time  to  GMT  time.   If  you  don't  create  this
  882.            environment  variable,  KSP-Mail  will  think  (by default)
  883.            that  you  are on Pacific Standard Time (PST)!  See details
  884.            in section 1.6 of KSP-MAIL.DOC.  
  885.  
  886.            New  Feature:  Added  support  for  an environment variable
  887.            (ksp-ip)  to  set  the IP address.  Since the IP address is
  888.            often  the  only  parameter in WATTCP.CFG that changes from
  889.            one  BBS  node  to another, this allows using a single copy
  890.            of that file for all nodes.  
  891.  
  892.            Clarification:  Some  Internet  access  providers configure
  893.            their  dial-up  slip  and  ppp  accounts  with a very small
  894.            segment  size.   You  may  need to set mss as low as 212 if
  895.            your Internet connection is through such a connection.  
  896.  
  897.      1.5:  Bug  Fix:  If  an  error  occured when trying to execute an
  898.            external  command,  the command line displayed in the error
  899.            message  did not show anything after the first command line
  900.            parameter,   even   though   all   parameters   were  used;
  901.            corrected.  
  902.  
  903.            Bug  Fix:  The  search  algorithm  for locating an external
  904.            command  would  fail if a complete pathspec for the command
  905.            was provided; corrected.  
  906.  
  907.            Clean  Up:  The  documentation and the sample configuration
  908.            file  used  an example command line for PCBoard's UUIN that
  909.            looked  like  "UUIN  -c  5".   UUIN  does  not support this
  910.            command  line  parameter;  it  should have been shown using
  911.            the  "-s"  parameter,  as  in  "UUIN  -S  SMTP" or "UUIN -S
  912.            NNTP".  Corrected.  
  913.  
  914.            Clean  Up:  If  external  commands  were  specified  in the
  915.            configuration   file,   they  would  trigger  even  if  the
  916.            corresponding    process   (Mail-In,   Mail-Out,   News-In,
  917.            News-Out) was disabled.  Corrected.  
  918.  
  919.      1.4:  New   Feature:  Added  a  new  configuration  parameter  to
  920.            disable  certain  options when swapping out memory in order
  921.            to    run    an    external    command.     The   parameter
  922.            "ksp-mail.dont_swap_to"  can  be  set  to  "xms", "ems", or
  923.            "disk".   One  or more swapping options may be disabled; if
  924.            all  are  disabled then KSP-Mail's memory image will not be
  925.            swapped out.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.                           WHAT'S NEW IN KSP-MAIL
  933.  
  934.  
  935.  
  936.            Oops!   When  I  fixed  the  search  algorithm  in  1.3,  I
  937.            accidentally  broke  the "include" directive in WATTCP.CFG.
  938.            Corrected.  
  939.  
  940.            Bug  Fix:  Had  a problem parsing a command line to execute
  941.            when   it   did  not  contain  any  command  line  options;
  942.            corrected.  
  943.  
  944.      1.3:  Enhancement:  KSP-Mail  now  looks  in three directories to
  945.            locate   the  WATTCP.CFG  configuration  file.   First,  it
  946.            checks  for  an environment variable called WATTCP.CFG that
  947.            specifies  the  directory.  Second, it looks in the current
  948.            (default)  directory.   Third, if still not found, it looks
  949.            in    the    directory   that   contains   the   executable
  950.            (KSP-MAIL.EXE).  
  951.  
  952.            Enhancement:   Added  a  screen  saver  and  an  associated
  953.            configuration  parameter (ksp-mail.screen_saver_seconds) to
  954.            control its timing.   
  955.  
  956.      1.2:  Some  UUCP  import/export  utility  programs (notably Clark
  957.            Development's  UUOUT)  apparently require LOTS of memory to
  958.            run.   Since  KSP-Mail uses about 230K itself, that made it
  959.            impossible  to  load  and  execute  some of these programs.
  960.            KSP-Mail  now  copies  its  memory image to XMS memory, EMS
  961.            memory,  or  a file (in that order of preference), and then
  962.            shrinks  down  to a tiny "stub" of around 2kb before trying
  963.            to  load  and  execute  a  program.  When the child program
  964.            terminates, KSP-Mail reloads its image and continues.  
  965.  
  966.      1.1:  The  documentation  forgot  to  mention an important detail
  967.            about  the  following  four  configuration  parameters that
  968.            specify MS/DOS command lines! 
  969.  
  970.                    ksp-mail.uucp2bbsmail_command
  971.                    ksp-mail.bbsmail2uucp_command
  972.                    ksp-mail.bbsnews2uucp_command
  973.                    ksp-mail.uucp2bbsnews_command
  974.  
  975.            If  the  command  line  text  includes any spaces, then the
  976.            entire  text  of  the  command  line  must be surrounded by
  977.            quotation marks, as in: 
  978.  
  979.                    ksp-mail.bbsmail2uucp_command="UUOUT -C 5" 
  980.  
  981.      1.0:  Initial release.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.